home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Crypto⁄Encryption / Encryplet.sit / Encryplet / About Encryplet next >
Text File  |  1996-05-09  |  18KB  |  243 lines

  1.  
  2.  
  3. Encryplet
  4. version 1.0fc1
  5. Last updated: May-96
  6.  
  7.  
  8. Copyright ©1995-96, Type & Graphics Pty Limited. All rights reserved.
  9. Author: Raïf S. Naffah <mailto:T-and-G@kagi.com>
  10.  
  11.  
  12.  
  13. Overview    
  14. Encryplet is a US$5 shareware AppleScript® droplet which makes it easy to encrypt and decrypt files by drag-and-dropping them onto a Desktop Encryptor icon (similar to the Desktop Printer icons in QuickDraw GX and System 7.5.1 and later).
  15.  
  16. Encryplet relies on your AppleScript-aware version of Philip Zimmermann's PGP software –MacPGP®– to perform encryption and decryption. For information on how to obtain MacPGP in the USA or Canada, first refer to <ftp://ftp.netcom.com/pub/dd/ddt/crypto/crypto_info/where> using your FTP client or a World Wide Web browser. For non-USA citizens, information on how to obtain MacPGP is available at Ståle Schumacher's International PGP Home Page <http://www.ifi.uio.no/~staalesc/PGP/>.
  17.  
  18. If you require human assistance on using the PGP software (not Encryplet), send e-mail to <mailto:pgp-help-humans@hks.net>. For Encryplet problems, questions, etc… send e-mail to <mailto:T-and-G@kagi.com>.
  19.  
  20. Note: Because PGP also compresses data when encrypting it, Encryplet can also be useful as an easy-to-use, effective data compression utility while it secures your private information - I was able to reduce some text files to 27% of their original size.
  21.  
  22.  
  23. Software required    
  24. To use Encryplet you need to have:
  25.  
  26. 1. An AppleEvent aware version of MacPGP,
  27. 2. The Scriptable Finder (MacOS 7.1.4 or later),
  28. 3. The AppleScript Extension in your Extensions folder, with the standard Apple osaxen, and of course
  29. 4. Encryplet.
  30.  
  31.  
  32. Installation    
  33. 1. Put Encryplet on your desktop so it can be accessible for drag-and-drop operation. Better still, put it somewhere else and create an alias to it (select it and choose Make Alias… under the File menu in the Finder or press Command-M key combo). Move the alias to an accessible place on your desktop.
  34.  
  35. 2. Double-click Encryplet and set its global preferences (see • Setting global preferences in next section).
  36.  
  37.  
  38. Operations    
  39. Encryplet can be launched in two ways and will behave differently accordingly.
  40.  
  41. 1. Double-clicking Encryplet icon: Allows setting global preferences, and
  42. 2. Drag-and-dropping file(s) and folder(s) onto Encryplet: PGP Encrypts or PGP Decrypts dropped file(s) and folder(s) contents. The output file(s) is/are always created in the same folder as the source.
  43.  
  44.  
  45. • Setting global preferences    
  46. When you double click Encryplet, it sets its global preferences. Here are the details:
  47.  
  48.  
  49. •• Setting your User-ID    
  50. Encryplet tries to locate your PGP Preferences file which is supposed to be located in the Preferences folder inside the active System Folder. If successful, Encryplet will read your User-ID information from this file and use it to PGP Encrypt the files you will drag-and-drop onto it after MacBinarising it/them.
  51.  
  52. Note: If Encryplet is unable to find a valid User-ID in the PGP Preferences file, or if this file does not exist, it prompts you to enter a value that will be used as a User-ID. Bear in mind, that if MacPGP is unable to act upon this value, an error (usually #21: RSA Key Encryption Error) will occur.
  53.  
  54.  
  55. •• Wipe Source File    
  56. Next, Encryplet will prompt you whether you want to wipe the source file(s) after you process it/them, be it after encryption or decryption. If you elect not to wipe the source file, the output file will overwrite the source if you have checked the Overwrite Files option under the Options menu in MacPGP.
  57.  
  58. Note: Overwriting a file does not wipe the contents of the old copy, so… do not consider Overwriting Files as a secure way of getting rid of clear (pre-encrypted) data. The Overwrite Files will not protect you from very sophisticated attacks.
  59.  
  60.  
  61. •• Quit MacPGP When Done    
  62. Finally, Encryplet will prompt you whether you want to quit the MacPGP application after it finishes using it for encryption and decryption of dropped objects (files and folders).
  63.  
  64. Note: If you answer yes to this question then remember that you'll have to enter your secret pass-phrase everytime Encryplet is launched to do its work.
  65.  
  66.  
  67. • Processing files    
  68. Encryplet will PGP Encrypt every file drag-and-dropped onto its icon, with you the user/owner as the recipient, after MacBinarizing it, unless the file is already a MacPGP encrypted file; ie. it bears MacPGP's signature. In the latter case, Encryplet opens it through MacPGP, causing it to be decrypted.
  69.  
  70. Note: Encryplet will always MacBinarise the file(s) you drop onto it. This will save all Macintosh related information such as the file's type and creator. In doing so, Encryplet when decrypting back the file, will restore it to its original double-clickable state.
  71.  
  72.  
  73. Scriptability    
  74. Encryplet's dictionary consists of the following:
  75.  
  76.  
  77. Required Suite:    
  78.  
  79. open: Open the specified object(s)
  80.       open  alias  -- list of objects to open
  81.  
  82. quit: Quit the Finder (direct parameter ignored)
  83.       quit
  84.  
  85. run: Sent to an application when it is double-clicked
  86.       run
  87.  
  88.  
  89. Encryplet Suite:    
  90. Copyright ©1995-6 Type & Graphics Pty Limited. All rights reserved.
  91.  
  92. Process1Object: Processes one Finder object.
  93.       Process1Object  file specification  -- Target Finder object.
  94.       Result:   anything
  95.  
  96. Process1Folder: Processes one Finder folder.
  97.       Process1Folder  file specification  -- path or alias to specified folder
  98.       Result:   anything
  99.  
  100. Process1File: Processes one Finder file.
  101.       Process1File  file specification  -- path or alias to specified file
  102.       Result:   anything
  103.  
  104.  
  105. Here is an example of processing a file through Encryplet
  106.  
  107. tell application "Encryplet"
  108.     launch
  109.     Process1File (alias "Disk:Desktop Folder:Web Audit Report For Accoun.pgp")
  110. end tell
  111.  
  112.  
  113. Acknowledments    
  114. Encryplet was beta-tested by, and refined based on responses from, the following people: Bjorn E. Andersson, Marshall Clow, Dave Del Torto,    Michel Eytan, Robert Guerra,  Dennis Steele and David Stoler. My gratitude goes to them and especially to Dave Del Torto who found the time to also review and improve this documentation. Any remaining weaknesses in the grammar or ambiguities in interpreting this text is mine and not his.
  115.  
  116.  
  117. Shareware Fee    
  118. Encryplet is copyright of Type & Graphics Pty Limited (ACN 061 642 779) —a Sydney-Australia based Business Communications company. All rights reserved. The author and copyright holders retain complete and exclusive rights to the program, but specifically allow re-distribution via the following channels:
  119.  
  120. 1. NON-COMMERCIAL bulletin board services,
  121. 2. INTERNET archives and file servers,
  122. 3. Disk libraries of NON-PROFIT organizations.
  123.  
  124. provided that all the contents of the folder containing the software and documentation are kept together.
  125.  
  126. Encryplet is Shareware. You may use the software for a trial period of 4 weeks. If you decide to continue using it, you must pay the shareware fee.
  127.  
  128. Encryplet has the following pricing:
  129.  
  130. • The individual user license fee is US$5, or AUD5 for Australian residents only.
  131. • A Site License costs US$100 and covers all locations for your organisation within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the Encryplet software.
  132. • A World-Wide License costs US$500 and it covers all locations for your organisation on the planet Earth.
  133.  
  134.  
  135. Paying for Encryplet    
  136. Paying for Encryplet is fairly simple. Open the Register program that accompanies Encryplet. Enter your name, your email address, and the number of single user licenses you desire for each program you wish to purchase (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi Shareware. Kagi Shareware handles my payment processing.
  137.  
  138. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi Shareware. Their email address is <mailto:shareware@kagi.com> and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste it into the body of an email message, or you can Save the data to a file which you attach to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to Kagi's fax number.
  139.  
  140. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct Internet email address you will receive an email acknowledgement.
  141.  
  142. If you are paying with Cash (outside Australia) or US$ Check you should print the data using the Register application and send it to the address shown on the form, which is:
  143.  
  144.           Kagi Shareware
  145.           1442-A Walnut Street #392-GT
  146.           Berkeley, California 94709-1405
  147.           USA
  148.  
  149. If you're a resident of Australia and are paying in AUD our address is:
  150.  
  151.           Type & Graphics Pty Limited
  152.           POB 5607
  153.           Chatswood West NSW 2057
  154.           Australia
  155.  
  156. You can pay with a wide variety of cash from different countries but at present if you pay via cheque, and unless you're a resident of Australia, it must be a cheque drawn in US$. Kagi Shareware cannot accept cheques in other currencies, the conversion rate for non-US$ cheques is around US$15 per cheque and that is just not practical.
  157.  
  158. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.
  159.  
  160. Kagi Shareware can not invoice your company, you need to act on our behalf and generate the invoice and handle all the paperwork on your end.
  161.  
  162. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  163.  
  164. Payments send via postal mail take time to reach Kagi Shareware and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi Shareware when the form is processed.
  165.  
  166.  
  167. License Agreement    
  168. Type & Graphics Pty Limited (T&G) is willing to license the enclosed Encryplet software (Software) to you (Licensee) on the condition that you accept all the terms contained in this Agreement. If you do not agree to these terms, you should not use this Software.
  169.  
  170. 1. License
  171. On the terms and conditions set forth below T&G hereby grants to the Licensee a non-exclusive license to use the Software and Documentation in the manners specified herein. T&G retains all rights not expressly granted to you in this Agreement.
  172.  
  173. 2. Ownership and License
  174. T&G at all times retains ownership of the Software. You own the media on which the Software is stored.
  175.  
  176. 3. Use of the Software
  177. (a) Rights to install and Use: (i)    You may not install the Software on a network server or on a networked computer such that     other persons may access and use the Software; (ii)    The Software may not be used by more than one person at the same time; (iii)    Subject to the conditions in 3 (a) (i) and 3 (a) (ii), you may install the Software on one or more computers of which you are the primary user.
  178. (b) Rights to Copy: You may copy the Software for backup and archival purposes, provided that the original and each and all copies are kept in your possession, and that your installation and use of the Software does not exceed that allowed in part (a) above.
  179. (c) Right to Transfer: You may transfer this license to use the Software to another party on a permanent basis by transferring this copy of the Agreement, at least one unaltered copy of the Software provided the other party reads and agrees to accept the terms and conditions of this license, and provided at the same time all other copies of the Software not being delivered to the other party are destroyed.
  180.  
  181. 4. Termination
  182. The license may be terminated at any time by the destruction of the Software and all copies of the Software or by the transfer of the license to another party pursuant to Section 3 (c). The license may be terminated by T&G without notice upon failure to comply with any provision of the license. Nothing in this Agreement constitutes a waiver of T&G rights under Australian Copyright law or any other law.
  183.  
  184. 5. Prohibited uses
  185. You may not: (a) Use, copy, modify, merge, or transfer the Software or copies of the Software except as provided in this Agreement; (b) Use any backup or archival copies of the Software, or allow someone else to use such copies, for any purpose other than to replace the original copy in the event it is destroyed or becomes defective; (c) Modify, adapt, translate, disassemble, decompile, reverse engineer, reproduce, disclose or in any manner decode the Software for any reason; (d) Sell, assign, mortgage, lease, license, sublicense, rent, lend, or otherwise deal with its rights and interests granted by this Agreement; (e) This section applies to any adaptations, copies, or derivative works based upon the Software in whole or in part.
  186.  
  187. 6. Disclaimer
  188. The Software is provided to you AS IS without warranty of any kind, either expressed or implied. T&G does not warrant, guarantee, or make representations regarding the use, or the results of the use, of the Software with respect to its correctness, accuracy, reliability, currentness or otherwise. The entire risk as to the results and performance of the Software is assumed by you. T&G makes no express or implied warranties including, but not limited to the implied warranties of merchantibility and fitness for any particular purpose, or arising from a course of dealing, usage, or trade practice, with respect to the software package. T&G shall not be liable for any claim, liability, damages, costs and expenses (including but not limited to attorney fees and costs of suit), or other loss caused, suffered, or incurred by you arising from your use of the Software. In no event shall T&G be liable for any loss or damage that may arise in connection with the furnishing, performance or use by you of the Software, including, without limitation, any direct, indirect, special, incidental or consequential damages. In no event you shall be entitled to any monetary damages against T&G in excess of the shareware license fees paid to T&G by you hereunder for the Software to which your claim relates.
  189.  
  190. 7. Governing law
  191. This License will be governed by and construed according to the laws of the State of New South Wales - Australia and the parties agree to submit to the non-exclusive jurisdiction of the courts of the State of New South Wales - Australia and of all courts having jurisdiction in appeal from the courts of the State of New South Wales - Australia.
  192.  
  193. 8. Severability
  194. If any part of this Agreement is found to be illegal, invalid or of no force or effect under any applicable laws, exclusive orders or regulations of any government authority having jurisdiction, this License shall be construed as though such part had not been inserted and the remiander of this License shall retain its full force and effect.
  195.  
  196. 9. US Government End Users
  197. If you are acquiring the Software and fonts on behalf of any unit or agency of the United States Government, the following provisions apply.  The US Government agrees: (i) if the Software and fonts are supplied to the Department of Defense (DoD), the Software and fonts are classified as "Commercial Computer Software" and the US Government is acquiring only "restricted rights" in the Software, its documentation and fonts as that term is defined in Clause 252.227-7013(c)(1) of the DFARS; and (ii) if the Software and fonts are supplied to any unit or agency of the United States Government other than DoD, the US Government's rights in the Software, its Documentation and fonts will be as defined in Clause 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause 18-52.227-86(d) of the NASA Supplement to the FAR.
  198.  
  199. 10. Entire Agreement
  200. This License contains the entire Agreement between the parties in relation to the use of the Software and Documentation and any representation, warranty, condition, promise, undertaking or other provision not expressly set out in this Agreement shall have no force or effect.
  201.  
  202.  
  203. Copyright notices    
  204. Copyright © 1995-96, Type & Graphics Pty Limited. All rights reserved.
  205. contact: Raïf S. Naffah <mailto:T-and-G@kagi.com>
  206.  
  207. Portion of this code is Copyright © 12/95 Tracy L. Hinshaw
  208.  
  209. MacPGP is copyright of Philip Zimmermann.
  210. The GTQ Scripting Library is copyright of Gregory T. Quinn.
  211.  
  212. Apple, Macintosh and AppleScript are registered trademarks of Apple Computers, Inc.
  213.  
  214. All other trademarks and registered trademarks are the property of their repsective owners.
  215.  
  216.  
  217. Version history    
  218. • Version 1.0fc1 — May 1996    
  219. — Final release.
  220.  
  221. • Version 1.0b1 — February 1996    
  222. — First public release.
  223.  
  224. • Version 1.0a2 — January 1996    
  225. — Minor bug fixes.
  226. — Added the Quit MacPGP When Done global preference.
  227. — Updated the documentation.
  228.  
  229. • Version 1.0a1 — January 1996    
  230. — Tightened the code that generates the PGP command to reduce MacPGP confusion re: user-id strings.
  231. — Corrected the dox.
  232.  
  233. • Version 1.0d2 — 27 December 1995    
  234. — Added aete resource and documentation on scriptability. Re-defined in the process the application's event names.
  235. — Packaged it as an application with TGD3 (registered with Apple Computer, Inc.) as its signature.
  236. — Better testing of file type and creator codes when decrypting (doesn't generate a WIPEFILE error)
  237. — Better error handling.
  238. — Total reliance on PGP commands. Only AppleEvent from the PGP suite used is the execute handler.
  239. — Corrected the dox.
  240.  
  241. • Version 1.0d1 — 25 December 1995    
  242. — Reduced distribution for beta-testing.
  243.